TCloud Assinador para Linux — estação de trabalho
=================================================

Assina PDF, XML e JSON neste computador com certificado A1 (arquivo .pfx) ou
A3 (token), com a mesma interface das versões Windows e Mac: escolha os
arquivos, o certificado e assine. Em "Posicionar e personalizar…" a chancela
do PDF é colocada com o mouse sobre a página, com logomarca, título e campos.
Os assinados são salvos ao lado dos originais, com "-assinado" no nome, e
marcados como somente leitura.

Pedidos do Atlas e do BookC: o sistema abre um link tcloudsign:// no
navegador e o assinador deste computador abre sozinho, baixa os documentos,
pede a confirmação (e o PIN, no token), assina e devolve.

Feito para as distribuições de desktop com GTK: Ubuntu, Debian, Linux Mint,
Fedora, openSUSE, Arch (GNOME, KDE, Cinnamon, XFCE). Testado no Ubuntu 24.04 e 26.04.
Precisa de sessão gráfica (X11 ou Wayland).

Instalar
--------
Pelo terminal, sem baixar nada à mão:
    curl -fsSL https://tcloudsoft.app/download/instalar-linux.sh | bash

Ou, com este pacote descompactado:
    bash "Instalar TCloud Assinador.sh"

O instalador confere os componentes e, se faltar algum, mostra o comando da
sua distribuição e oferece rodá-lo (pede a senha do sudo só nessa hora):
  - janela: GTK + WebKitGTK (python3-gi, gir1.2-webkit2-4.1 no Ubuntu/Debian)
  - prévia das páginas: poppler-utils (pdftoppm)
  - certificado A1: openssl
  - recomendados: zenity, libsecret-tools (chaveiro), libnotify

Certificados
------------
- A1: botão "Importar A1…" no app. O arquivo fica numa pasta só sua
  (~/.local/share/TCloud/Assinador/certificados, permissão 0600) e a senha
  vai para o chaveiro do sistema (GNOME Keyring / KWallet).
- A3: instale o driver do token do fabricante para Linux (SafeNet
  Authentication Client, SafeSign, Watchdata, OpenSC...). O assinador acha a
  biblioteca PKCS#11 sozinho; se estiver num caminho diferente, informe em
  ~/.local/share/TCloud/Assinador/estacao.json:
      "pkcs11": "/caminho/para/a/biblioteca.so"

Na primeira assinatura pelo Atlas/BookC, o navegador pergunta se pode abrir o
TCloud Assinador (marque "sempre permitir" para o site) e o assinador pergunta
se confia no sistema (confirme).

Se algo não funcionar, rode no terminal e envie o resultado ao suporte:
    python3 ~/.local/share/TCloud/Assinador/tcloud_assistente.py diagnostico

Se a janela não abrir: o assinador abre a mesma tela no navegador depois de
25 segundos. Envie ao suporte os registros abaixo.
Registros: ~/.local/state/TCloud/TCloudAssinador.log e TCloudAssinador-janela.log
Para atualizar, rode o instalador da versão nova.
Para remover: bash "Desinstalar TCloud Assinador.sh"
